README

 

Greeting! Thank you for downloading AliceChat v2.2

You must read the whole page or you'll lost.

Disclaimer

This is AliceChat v2.2, an mIRC addon for J-Alice (an A.L.I.C.E ChatterBot Engine). This release is slightly has big difference compare to the v1.0. It's now a *socket bot that has it's own brain! It's awesome! isn't it? :)

The release of AliceChat v2.2 contains fixes of IRCd compatibility and control codes stripping. Other changes plz refer CHANGES.txt file. I'm sorry for the extreamly fast new updates because the bugs are really nasty; it won't work at all if I don't fix it, and I hope a new release should be always the best!(?)

*I remind you that this addon is a socket bot that chatting using its own brain. Anyone who don't like such bot please don't load it!

What is A.L.I.C.E?

A.L.I.C.E is a chatterbot that has A.I (Artificial Intelligent)
to talk and act like a human.

A.L.I.C.E/AIML was originally created by Dr. Richard S. Wallace.
(A.L.I.C.E is winner of the Loebner AI Contest for 2000, 2001 and 2004)
Take a look at A.L.I.C.E Foundation Official Website

What is AliceChat?

1. AliceChat uses J-Alice, an Open Source project; another version of A.L.I.C.E. engine
by Jonathan Roewen and Taras Glek <http://j-alice.org>
AliceChat will connect to J-Alice server and request the reply from the bot.
So, you MUST have a copy of Win32 built of J-Alice on your box in order to make it works with this addon.

2. The main purpose of AliceChat is for development of A.I (Artificial Intelligent) into mIRC. It doesn't mean to replace or to compare to other existing irc bots because AliceChat is only a chatterbot; but it could be compared to any other irc bots on her class.

3. AliceChat v2.2 is a socket bot, means that it will run as a "virtual client" from your mIRC client.
So, you do not need to load this addon into a dedicated mIRC client to run it.
Note on clone connections, this will make 2 connections from your IP to IRC network. One for AliceChat, and one for yourself. You need to handle this on restricted IRC Network, or just connect to other unrestricted IRC Network.

How to install AliceChat?

1. *Download J-Alice from http://prdownloads.sourceforge.net/j-alice/j-alice-win32-0.5.zip?download

2. Go to the downloaded J-Alice. It's a Zip archive. The original filename should be j-alice-win32-0.5.zip.Unzip it anywhere you like.

3. Unzip _all_ AliceChat (the addon) archive to anywhere you like. You should already unzip it when you are read this file. Load the script called alice.mrc by writting down this into your mIRC console :

    /load -rs path\to\alice.mrc

or by hitting Alt-R then click File --> Load.. browse to alice.mrc

*some people worrying of viruses on precompiled sources. This site is hosted by SourceForge.net and I'm guaranteed this source is absolutely clean. So, plz download from here ONLY! Still doubting about this LARGEST Open Source Community? Then get the source code and compile it yourself, OR go to hell with your paranoid!!

How to use it?

1. Go inside j-alice-win32-0.5 folder. Plz edit the file named j-alice.ini using Notepad. Search for word [IRC]. Under the section, you'll see --OpenProjects.Net--. Edit the Enabled=true to Enabled=false. We are going to connect to our irc server, so we don't need that connection. Save it and close the file.

2. Click on executable j-alice.exe with big J icon. You can safely execute it and run on *default port 8000.

*Note: Plz edit the j-alice.ini on [Web Server] section _ONLY IF_ any other program already used port 8000, also the AliceChat's setting. Replace 8000 with another free port. No deal with firewall or such because J-Alice is only for local use.

3. Run mIRC. You must get connected to your IRC network.

4. Right click on mIRC Status window. You should see AliceChat on popup list. If you don't, then check either you're already load alice.mrc or not. Also, a few scripts may acountered some problems with popup, so plz type /alicechat instead.

5. For first time using, click on AliceChat --> Setting . or by type /alicesett on mIRC console. The mIRC will bring you a setting dialog and fill them correctly. If you have changed J-Alice port, don't forget to change it here. The setting only need to be configured on the first time using. Then, you only need to click on AliceChat --> Connect, or type /alicechat next time you use AliceChat. Any changes, you need to spawn the setting dialog, of course. Note that the BotMaster is the nick that have full control on the bot.

6. Your bot should be correctly connected to your irc server. It runs smoothly on irc.malaynet.org (using UnrealIRCD) and should run well on other IRC Server, because it's using the simplest socket command..and very common. If you are facing any problem, then right click, AliceChat --> View --> Debug or type /alice.dbg on mIRC console. Then re-connect the bot, and the output will fill the window. You may see the errors there. Go to AliceChat script directory, you'll find a file named debug.log inside data directory . Write an email and attach it to me. Plz note that the debug.log file will renew each time AliceChat make a new connection.

7. The bot will open a query/msg to give you some usefull information when it succesfully connected. You can start chatting with the bot!

8. You can start chatting with the bot by saying her name on any specified channel (refer to Available Command)

9. You can kill the bot by right click, AliceChat --> Disconnect or type /alicedie .

10. As a BotMaster, your nick is automatically added to chatter list. So, just /msg botnick or query her to start chatting! Have Fun! :D

Available Command

    !help - Will show you available commands

    !join <#chan> - Join me a channel

    - This command will let the bot join any specified channel. The *Start Chat is automatically enable when bot joining channel; because the bot is designly for chatting, not for idling.

    !part <#chan> - Part me joined channel

    - This command will let the bot part any specified joined channel. It'll leave the channel without msg and *Stop Chat on that channel.

    !start <#chan/nick> - Start AliceChat on #chan/nick

    - This command will enable Start Chat with specified channel or nick. On channel, this command only work on joined channel (with command !join #chan) and can't issue if the bot is not on the channel. On nick, this command will enable the Start Chat with specified nick, no need to join nick, of course! After issuing the command, a custom window with prefix "Alice.thenick" will be created. You might enter any "greeting" msgs you like to initiate the session. Then leave it to the bot to carry on the conversation. You can monitor the query from here. You also can send "smart msg" to the nick that you will act like a _smart bot_ here.. and he will never know it! :P

    !stop <#chan/nick> - Start AliceChat on #chan/nick

    - This command is the !start command partner. On channel, the command will Stop Chat on the specified channel. It does not part the channel, only shut up and ignore all msgs and activities on that channel. On nick, it'll Stop Chat with the specified nick. It'll be completely removed the nick from chatter list.(refer the !status command)

    !say <#chan/nick> <msg> - Make AliceChat saying on #chan/nick

    - This command will make the bot saying any words from BotMaster on specified channel or nick. With this command, it's possible to link your bot to other bot by typing /msg botnick !say #chan otherbot: hello on mIRC console. Make sure your bot and "otherbot" are able to talk on that channel (joined and Start Chat). You can replace the word "hello" with anything you like.

    !act <#chan/nick> <msg> - Make AliceChat acting (action) on #chan/nick

    - This command will make the bot acting any words from BotMaster on specified channel or nick.

    !notice <#chan/nick> <msg> - Make AliceChat notice on #chan/nick

    - Just like !say and !act, this command will make the bot notice any words from BotMaster on specified channel or nick.

    !raw <command> [string] - Issue custom command

    - This command allows BotMaster to issue any raw command to irc server; through the bot. This command enable the bot to function like a normal irc client; issuing other commands that a normal irc client can issue.

    !stopall - Will Stop AliceChat on ALL #chan/nick

    - As the command said, this command will stop Start Chat on ALL channel and nick. Once you issue this command, you are able to Start Chat back. Just use !start <#chan/nick> command on each channel and nick.

    !status - Show you some Status on AliceChat

    - This will be a usefull command to know about your bot's status. It will be listing joined channels and nicks that currently chatting with your bot. The word "Enable" or "Disable" at the end of channel name's is refer to Start Chat and Stop Chat status. At the end of listing, Lines Received: shows count of queries from chatters to the bot. Lines Sent: shows count of reply from bot to chatters. It may differ on receive and send because the bot using anti-flood that only receive a query within 5 seconds. The difference may happen when a chatter send a new msg to the bot before it answer to the previous msg, this will ignore the previous msg. J-Alice status shows the J-Alice is started or not.

    *Reference:
    Start Chat is refering to succesfull command of !start <#chan/nick>
    Stop Chat is refering to succesfull command of !stopt <#chan/nick>
    The term "bot" on these commands refer to AliceChat.

You can monitor all msgs issued by/to bot on a window. Right click AliceChat --> View --> Monitor, or type /alice.mon on mIRC console.

All commands to bot also can be issued from popup with same function and ability. AliceChat --> Command --> This is for lazy ppl only. :P

End of commands available for AliceChat v2.2

Some words

Millions of thanks to all mIRC fans!

This addon is no mean to make fool to anyone. Someone claimed that a man has been chat with his AliceChat v1.0 for an hour!; without knowing that he was chatting with a bot! I can't believe it! I should get the logs. Anyway, it may happen to anybody if you really mean to fool any people! This addon is a real purpose of A.I. (Artificial Intelligent) developement and her future on mIRC and of course for fun!

As you can see on editing j-alice.ini, the J-Alice configuration file (consider you've already done the installation), J-Alice has internal irc client that can connect to any specified irc server. But, it's not quit handy. The point I wrote this addon is to make the connection and session more handy on various irc server, also on various BotMaster commands. The internal irc feature also doesn't support "smart msg" from bot to chatter nick! (refer Available Command) This addon also possible to use remote J-Alice (not on local machine). If you have J-Alice installed and run on other machine,(sharing J-Alice, anyone?) you can set on Setting dialog by changing "localhost" and "8000" to any desire value.

Since AliceChat v2.2, there are 4 new commands. They are 3 messaging stuff , and a raw command. Do you like these commands? should be they added to the next release? You may use this feature to start linking two or more AliceChat on a channel (by saying other AliceChat's nick through your AliceChat; refer Available Command). You will see the bots replying each other, watching their conversation and make your channel more happening. The bot's words may get bigger and bigger, but it'll reduce it slowly, so don't worry about flooding your channel. It's a big feature. It's great! :D

If anyone interested of getting costum AIML files (the bot's _very_ brain) plz go to http://www.alicebot.org. Maybe you'll find your native language AIML files there, not only English on the package or getting any modified AIML. Plz read their docs before downloading these files.

About MARY project (mIRC A.L.I.C.E engine). (dated 14 Oct 04) I'm currently working on xml.dll from sax ( www.ScriptsDB.org) to parse the AIML files (a type of XML). It's also deal with hash table to handle the loaded data from parsed AIML. Anyone interested plz read the ALICE Docs at http://www.alicebot.org/documentation . Get understand what is ALICE and how it works. I will contact Dr. Richard Wallace once MARY Engine done! Anyone has the xml.dll docs that written in english? babelfish is not always the best way :/

AliceChat v2.2 and previous versions are under GNU GPL License v2 or any later version and J-Alice is under MIT License, (not GPL). So plz don't confuse of which license belongs to. Plz read the license to understand what it does. You can say license is a small deal in mIRC scripts, but it is not on other projects outside the mIRC scripts, and I remind you again that I'm ONLY writing AliceChat, not J-Alice. About ripping stuff on AliceChat, I got nothing to say. AliceChat is copyrighted. The GNU License says,(not me) "Activities other than copying, distribution and modification are not covered by this License" So, cannot redistribute AliceChat as yours.

I'm very disappointed to hear that J-Alice can't run on most Windows 9x/ME. Some do run ok, but most are don't. It's only works fine on WinNT family; Win2k, WinXP and Win2003. I can't wait to run AliceChat on very own MARY engine and throw away J-Alice!..big thanx to J-Alice anyway.

Plz send me an email if you find any bugs or to send any suggestions or comments; even if you can fix any bugs by yourself, but plz let me know the bugs. It should be fixed on next release. :)

Final Words

Come on join us at Malaynet IRC Network. We are spawning a few new IRC Servers and need a bunch of new IRCops. Newbies (knowing IRC a couple of months or never OPing before) who like to be an IRCop are welcome! ..of course as long as you pass the IRCop Test (is it hard? have a look at Malaynet Portal) and able to do some volunteer works..etc

Happy chatting guys! :D

..Mariam..you are the MARY mascot!

- bizkut @ Official Team Malaynet IRC Network :: irc.malaynet.org #Malaynet
- Email: bizkut@gamebox.net
- Farm: Official Team Malaynet Website :: www.malaynet.org


© 2001-2004 bizkut limau